home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / comm / comm2 / ctdcs701.lha / error.reasons < prev    next >
Text File  |  1996-07-08  |  7KB  |  144 lines
  1.                              Citadel Errors & problems List
  2.  In general, if you get an error and this list does not tell you how to
  3.  correct it, collect as much information as possible and report what
  4.  happended either directly to me or in the Citadel 68k room.  The first
  5.  thing to look for is a file called debug.sys or crash.sys.  These files
  6.  should appear in either your audit area, the home area, or the location
  7.  you started up Citadel.  I usually will want the information in these
  8.  files(even if it is just a cryptic one line message like "dependant variables
  9.  mismatch", sometimes it tells me exactly where the problem is).  The second
  10.  thing I will tell you to do is turn on debug, Here is a general method I
  11.  end up telling people:
  12.  
  13.      1) go into the Sysop menu, turn on debug "D" option.
  14.      2) Shut down your Citadel, "X" option.
  15.      3) delete debug.sys in the audit area(or save it if it contains
  16.         info I might need.  At the least, edit the file and add some
  17.         markers (like two lines of asterisks) at the end of the file.
  18.      4) Bring up Citadel and attempt to reproduce the problem.  If you
  19.         cannot do it locally, you might even ask a remote user to do it
  20.         for you.  leave debug on.  Note:  If you run confg, debug is
  21.         automatically turned off, repeat the above steps.
  22.      5) archive all the information(using something like lha) and arrange
  23.         to get the information to me.  I may call your BBS to download the
  24.         file so make some arrangements in Citadel 68K so I know where it
  25.         is.
  26.  
  27.  
  28.  Error:  [1]IOError = nnnn
  29.  Error:  [2]IOError = nnnn
  30.  Reason:  nnnn is a result code returned from a serial port i/o, usually
  31.           a dropped carrier(small timing window for a race condition could
  32.           cause this).  The error is handled for 99% of the cases in a way
  33.           that will cause Citadel to recover and reset.  [1] is the case
  34.           where i check to see what is in the serial port buffer, and [2]
  35.           is when the actual read is done.
  36.  
  37.  Error:   Startup Error Code nn
  38.  Reason:  something went wrong during system initialization. The reasons
  39.           are:
  40.           1 - unable to open intuition.library, you must be 1.2 or greater
  41.               to run Citadel.
  42.           2 - unable to open graphics.library, same as 1, or could
  43.               not open req.library, check your libs: for req.library, it
  44.               is required for Citadel operation.
  45.           3 - Insufficient Stack space, Citadel versions 3.42.E19 and
  46.               earlier required a large stack, much larger than needed
  47.               (50K).  Versions 3.42.E20 and later will require a 20K
  48.               stack or less(I am still adjusting the values down).
  49.               3.43 will probably require an 8K stack since all the tests
  50.               I have done show a 3 k stack is enough.  Citadel still
  51.               requires the larger limits.
  52.          11 - Console Open Error.  Catch all for console window errors
  53.               If you are using #WBSCREEN, try without it.
  54.          25 - Open Serial Port Failed, Well, Citadel could not get to
  55.               the serial port(maybe something else has it open, or you
  56.               have Citadel running twice?).
  57.          31 - Could not create a Port for timer communications, Low
  58.               memory?  Trashed system tables?  Try a re-boot.  This is
  59.               one of those, "you should never get here".  If you bug me
  60.               with this type of problem, you had better have a full
  61.               system configuration and alot of details.
  62.          32 - could not create an I/O request. See 31.
  63.          33 - Open timer.device failed.  See 31.
  64.  
  65.   Note:  In the serial port open errors, and in most cases with debug
  66.   turned on, you will get a text error message of the form:
  67.  
  68.    1:    Date - Dos Error:nnnn
  69.    2:    (some text as to what happened)
  70.    3:    (some text as to what happened) <-- you may get only one line.
  71.    4:    Reason: <error text>
  72.    5:    Current Directory
  73.  
  74.    Line 1: is the internal error code(less than 100), or the Dos error
  75.    code.
  76.    Lines 2-3: will either be a command(like in the external protocols) and
  77.    a text line, or just one line of text.  External commands will display
  78.    the text and command, most errors do not have an external command.
  79.    4: is the reason the error occured(from the Exec routine Fault).
  80.    5: is the current directory.  This is important if you are trying to
  81.       setup a door for example and in the wrong directory.
  82.  
  83.  If the problem is reproducable, do it several times and record all possible
  84.  information, especially your system configuration!  If it happens just
  85.  once and you can not reproduce it, then still record what you can, check
  86.  things like memory in use, what is running.
  87.  
  88.  Note:  If you have a problem that seems to happen often, realize that I
  89.  rarely have a crash.  Pleae check to see that something else is not causing
  90.  the problem.  Remove commodities, other programs and see if you can cause
  91.  the problem without that super-duper-whiz-bang mouse accelerator/screen
  92.  blanker!  It probably ain't Citadel!
  93.  
  94.  
  95.  There has always been more than a few questions about why you
  96.  get the cryptic messages about Itl_Send Failure nn Mode mm.
  97.  This is a little chart that sort of explains what these are:
  98.  
  99.   Mode is one of two values:  1 = Startup(and can mean during the
  100.                                   tranfer).
  101.                               2 = Finish.
  102.   The Failure code has many possible meanings:
  103.   Code   Description
  104.    1     No luck starting transmission(you should not see this)
  105.    2     Transmission cancelled.  This usually means the other side
  106.          did a cancel.
  107.    3     No transmission startup.  This is a timeout(maybe the other
  108.          side hung).
  109.    4     Transmission Failure.  This is one of many possibilities.
  110.          - Time out error
  111.          - Carrier Loss
  112.          - Write Error on your disk! Disk error, out of space
  113.          - NAK'ed 10 times on a transmission
  114.          - Cancelled at the end of the transmission
  115.          - Transmission Aborted
  116.            . Carrier Loss
  117.            . Too many Errors(10 consecutive)
  118.    9     Carrier Lost.
  119.  
  120.    Note:  I commonly see:
  121.  
  122.      ITL_SEND Failure 4 Mode 1  and ITL_SEND Failure 3 Mode 1
  123.  
  124.    Which means literally, Transmission error on Startup.  This happens
  125.    a when I network with K2NE Citadels and Fnordadels which seem to drop
  126.    carrier rather quickly when done.  It is not a problem.  This always
  127.    occurs at the end of a net session.
  128.  
  129.    You should probably never see:
  130.  
  131.      ITL_SEND Failure 1 Mode 1
  132.  
  133.    Since that would mean no attempt a determining the connection protocol
  134.    and compression method(even no compression) were accepted!
  135.  
  136.    In many cases, if you turn on debug, the reasons are captured in the
  137.    debug.sys file(if an audit area is defined).  In the netlog(if turned
  138.    on!), the reason is usually displayed above the ITL_SEND Failure message.
  139.  
  140.    If you get strange errors and they occur frequently, check your line
  141.    for line noise and make sure you have your dial strings correct for your
  142.    modem.  You can see the dial strings by turning on debug and forcing a
  143.    net session with ^A (control-A).
  144.